
View: PLUSWORKS DOX

I.  Plus works what does it do?

Plus works is a patch program that allows the Apple 2+ user to join the world of
appleworks. Plus works will modify the Appleworks start-up disk allowing the
program to operate on a Apple 2, 2+, Clone or Franklin Plus works will recognize
most popular peripheral slot ram cards and will use 100 % of it"s ram memory for
desk-top expansion up to 1 Megabyte. For configurations of 256K and above two
additional ram disk features are included, minimizing disk access time after
start-up.

II Hardware requirements
  Plus works currently supports Videx hardware compatible *0 column Cards in slot 3. see section 4 for display details. Plus works and appleworks both require 64 K, therefore a 16K language card or equivalent is required in slot 0. If your computer has the standard Apple keyboard the popular shift key modification is required. This program supports desk-top expansion into many popular ram cards from 16K to 1024K  The Ram cards can occupy any slot except 3 and 6. Those supported are Legend, saturn, Titan, equivalents.


III. Installation

All steps are performed on drive one (boot drive). If you wish to run Appleworks
on a hard drive you must install the patches first and then transfer the
Appleworks files to the Hard drive..

1.  On a properly configured computer, install the Plusworks disk and power up
the machine.

2. The disk drive will start and quickly stop prompting you to install the
Appleworks Start-up disk. Install the disk and press a key to continue.

3.  When you are prompted to insert the Plusworks disk again, do so and press a
key to continue

4. After the standard Pro dos greeting, the screen will switch to 80 columns. If
you need to manually switch display devices, do so now. If you display appears
to not be properly formatted it is probably because your hardware does not
respond to the standard Chr$$(30) XY formatting sequence. This will not cause
problems with Appleworks at run-time. You will probably have to override the
display test failure later on. see section 4 for compatible display test.

5. The program will prompt you to insert the Appleworks start-up disk for the
last time. Make sure that you insert a copy of the disk as as the disk will be
permanently modified.

6. The program will then ask for a few responses to questions.. the first is
"keyboard type" . If you have the the standard apple 2 with the shift mod then
answer "1". If you machine has a full ascii keyboard then answer "2" If you
answer 2 then you will be asked a number of questions in order to allow you to
somewhat customize your keyboard driver. The next choice is the lead in key.
This is the key-press that emulates the open apple key of the Apple 2e. Finally
your choice for the "delete key" will be made.

7. When you are satisfied with your keyboard choices you are then asked whether
a printer patch should be installed. Choose no unless you know for sure that you
have printer problems. See section 5 for additional information. The next
question will ask which slot contains the Ramcard. The card must be installed
for successful configuration. If 256K or more of ram is found then you will be
asked to decide on the permanent ram disk option. Selecting yes sets this
feature up as the default at start-up. However the dynamic ram option will still
be available at run-time. See section 4D for a complete description of this
feature.

8. At this point configuration is complete and you may press a key and start
using Appleworks. If you wish to change the Appleworks configuration, please
start with a fresh copy of the Appleworks diskette.

IV  Using the modified Appleworks 

The key sequences necessary to achieve a fully functioning Appleworks balanced
with the ease of use of the software has been the product of careful
consideration and testing. We are confident that the user will be quite
comfortable and satisfied with our choices. The following is not a description
of how to use Appleworks. It is assumed that the user is at least somewhat
familiar with the operating features of Appleworks and we present only the
information on transposing the 2e/c keyboard functions.

 A. General Keyboard features.

Open Apple functions are available to you by first pressing the lead-in key,
then the desired function key. For example, if you want a hard copy of the
current screen (open apple H) , press the lead in key and then "H". When the
lead-in key is pressed, an inverse "+" appears at the active position. To return
from an inadvertent lead in press, press an unused open apple key such as the 0
key. Alternately since an open apple key is nothing more than a game button
press, one may choose to use a game button as such. Note that a game button must
be pressed at the same time as the desired open apple function. It is not a lead
in sequence. Remapping of certain control keys has yielded a convenient, easy to
remember cluster of keys for cursor movement. While the right and left arrow
keys work as they do with a 2e, ease of cursor movement has been achieved by
remapping the control E,S,D,X  keys. While holding the control key down up,left
right and down movements can be achieved by using the E,S,D,X keys. Emulation 
of the the open apple arrow cursor movements ,that is , up,and down by page ,and
left and right by word is implemented differently on different keyboards and is
discussed in the separate sections that follow as are other features unique to
each. Literal control codes are sometimes required for printer setup strings .
If a control character is required that has been remapped , it is obtainable by
first pressing the lead-in key.

  B. The Apple 2, 2+ keyboard.

The lead-in key is the esc key. To generate a real esc., press  esc twice. Open
apple cursor movements are accomplished by pressing shift control  and E,S,D,X.
The delete key  is handled with the shift left arrow. Caps lock is Control"A" .
Characters not normally available on the 2+ can be generated by first pressing
esc , then the following:


          to get this        press esc., then this
                  
                   ]                   >
                   [                   <
                   }                   )
                   {                   (
                   \                   /
                   |                   !
                   `                   '
                   ~                   =
                   _                   -


The ^ and the @ are also obtained by pressing esc. Keep that in mind when
entering control codes for printer setups (requires ^ to exit) Tab is Control I.
Open apple tab (reverse Tab) is shift control I . One additional note, open
apple -" (ditto) is obtained with esc shift -" not unshifted as as described in
the appleworks manual or with game button shift 7 (').

   C. Full ascii keyboards\

If the Ace 1200 keypad is selected and you have an Ace 1200, the action of the
menu keys 1-9 are self explanatory, assuming you have selected menu as the lead
in key. Delete function is <del char> or whatever key you had selected during
configuration. The <insert> key is the open apple tab (reverse tab) function
required for moving left through the data base. The <formt> key is not remapped
since it is equivalent to control B a valid appleworks function key.(bold).

With other full ascii keyboards, the following keys when typed along with the
control key, serve the same function as the keypad keys.

         Cntl-A    Hex 81    Left one word
         Cntl-F    Hex 86    Right one word
         Cntrl-R   Hex 92    Up one page
         Cntrl-C   Hex 83    Down one page
         Cntrl-V   Hex 96    reverse Tab

Note that the A-F surrounds the S-D (left-right) and R-C is next to the E-X
(up-down). The special characters described in section 4 are also available;e
using the lead in sequence. The ditto is mapped as <cntl-">. Remember, for
generating real control key values for the printer string setups etc., use the
lead-in key sequence. If your keyboard has programmable function keys, use the
values above to obtain the corresponding functions.

  D. The Ram Disk Features

Appleworks is a very large program, all of the parts of which cannot be in main
memory at the sane time. For this reason, the program disk is called upon
frequently to overlay certain portions of memory in response to the users
functional requests.  Appleworks has a built in capability for dynamic storage
of program code modules. It store these modules in unused in unused desk-top
space.. With a sufficiently large desk-top, a module only need be loaded once
from the disk. Subsequent requests are serviced by the desk-top storage driver.
The users data of course has the highest priority and as the data grows, the
available desk-top space shrinks and modules are removed. This will force disk
access at a later time. With this in mind, it is apparent that a larger desk-top
represents not only a greater space for data but a savings in time when moving
between different sections of the program. The following are descriptions of the
two options available for further reducing or eliminating program disk access
for ramcards of 256K or greater.

      Dynamic Ram Disk

With this option, the user selects to store all of the modules in the free
desk-top space at start up time. This procedure takes a bit of time to execute,
but afterward, disk access is dramatically reduced. It is, however, not
completely eliminated , and the program disk must be left in the drive. This
feature is automatically enabled with 256k or greater ramcards, but will not
function unless called for at start-up time. To select this option, do the
following. During the Appleworks start-up, when prompted to insert the
Appleworks  program disk, insert it in the drive and press <space> instead of
<return>. The module transfer will begin and take approximately 75 seconds to
complete. This feature has limited utility and most users will find the start-up
time annoying. However, if appleworks is started early in the day and is
utilized for various purpose throughout the day, this feature is, indeed,
useful.

     Permanent Ram Disk

This option is a real Ram disk. It partitions the memory on the ramcard into
usable desk-top and a pseudo disk. The obvious disadvantage to this is the
obvious loss of 144K of desk-top space, but it does have two advantages over
dynamic ram disk. One is loading time. You only have to wait 20 second after
entering the date before reaching the Appleworks menu. The other is that one
drive is now free. Chances are you have more data than can fit on one diskette.
Now you can swap less often. The dynamic ram disk is still an option that can be
made at start-up time. The same instructions apply as described above and the
full desk-top is restored. This can be useful in temporarily expanding the for
special needs.

V  Printer Patch

This is a feature unrelated to screen display and memory management. It has been
included as a service to our customers who have had difficulty obtaining
complete control of printer options due to interface incompatibility. The patch
simply sets the eighth bit of each character sent to the printer interface. This
is required by some printer interfaces for proper formatting. We recommend
choosing "no" , but if you discover problems later on, simply rerun Plusworks
and chose yes for the printer patch function. The symptoms are fairly specific
and include all or part of the interface string (80N) appearing at the beginning
of the printout, gaps in the lines, improper right margins and inability to
achieve lines longer than 80 characters even when the appropriate set up string
is supplied.

--- Important ------

If the setup string is appearing on the printout, it is likely that the 40
column echo has not been disabled. This means that even though you can't see
them, characters are being sent to the 40 column screen. This is a function of
the interface and it means that the set up string has been ignored. This is a
clear indication for using the eight bit patch. $0 columns must be disabled
because part of plusworks occupies some of the unused screen memory. It is
recommended that users upgrade to version 1.2 of Appleworks. This version
contains a feature that permits installing a printer setup string. The
recommended string is <cntrl I> o n and is installed under interface cards in
the printer setup section.

VI  80 Column Cards

The patches do not use the 80 column firmware. As a result, full videx
compatibility is not required . A surprising number of card are hardware
compatible and will function properly. Inverse characters must be available. If
you are unsure about the display compatibility of your hardware, type in the
following short machine language routine.

1. With no disk in the drive, cold start the computer and press reset.

2. at the ] prompt type call -151

3. at the * prompt type 300:A9 0C 20 00 C3 A9 0A 8D B0 C0 A9 20 8D B1 C0 A2 00
BD 25 03 F0 FE 48 8A 0A 0A AB B9 B0 C0 E8 68 8D 5F CD D0 EC CE 44 53 CC 00 N
300G <RETURN>

4. If your 80 column switch is manual then switch now

5. The display should contain four charactersa in a tilted diamond shape. From
the top to bottom, inverse N, normal D, Normal S, and inverse L. There should be
no cursor.

